=== Post Thumb Revisited ===
Tags: thumbnails, post images, resize, highslide
Contributors: Alakhnor.
Requires at least: 2.0.7
Tested up to: 2.2
Stable tag: 2.0

Post-Thumb Revisited cre automatiquement et affiche des miniatures pour les articles. De nombreuses fonctions et options permettant de modifier les thmes sont disponibles.

== Description ==

Le plugin scan les articles  la recherche d'images. Il peut alors, effectuer les actions suivantes :

* Affichage dans la Boucle : affiche une miniature lie  un article.
* Affichage dans la sidebar : affiche des miniatures des derniers articles ou des miniatures d'articles choisis au hasard.

Toutes les miniatures sont cres dynamiquement, " la vole", et sauvegardes. Il n'y a donc pas  s'embarasser  grer les miniatures.
L'excellente bibliothque javascript Highslide est incluse dans le plugin et permet d'ajouter des effets d'ouverture des plus esthtiques aux miniatures ou liens grs par post-thumb revisited.


== Installation ==

1. Tlcharger et dzipper le fichier.
2. Uploader le rpertoire "post-thumb" dans le rpertoire des plugins de votre blog WordPress.
3. Activer le plugin depuis le panneau d'administration.
4. Aller dans options->post thumb et configurer les options avant de l'utiliser.

Important : Vous devez configurer les options d'emplacement correctement sinon le plugin ne fonctionnera pas.


== Dtails des options ==

Laissez les paramtres par dfaut si vous hsitez. Lors de la sauvegarde des options, les principales options sont valides et un message d'erreur indique si un problme a t dtect.


= Options d'emplacement =

"Chemin du domaine sur le serveur", "Nom de domaine complet" and "Rpertoire qui contiendra les thumbnails" doivent tre configurs correctement ou le plugin ne fonctionnera pas.

* Chemin du domaine sur le serveur : Chemin absolu du site. Par exemple, /httpdocs ou /yourdomain.com. Utilis pour retrouver l'emplacement des thumbnails sur le serveur. L'adresse http://yourdomain.com/images/pth/thumb_picture.jpg se traduirait en /httpdocs/images/pth/thumb_picture.jpg. Pas de '/' final.
* Nom de domaine complet : Nom de domaine complet, incluant le http://. Pas de '/' final.
* Rpertoire qui contiendra les thumbnails : Dfinit le chemin relatif vers les thumbnails. Assurez-vous que le rpertoire existe et peut tre modifi (chmod 777). Pas de '/' final.
* Image par dfaut : L'emplacement de l'image par dfaut  utiliser si aucune rfrence d'image n'est trouve. Entrez l'adresse relative depuis le site, par exemple, images/default.jpg
* Utiliser les meta-data ?
* Utiliser les noms de catgories : Si les noms de catgories sont utiliss, le nouveau nom constitu remplacera l'image par dfaut des images et l'image par dfaut des vidos. Les images de catgorie doivent se trouver dans le mme rpertoire que l'image par dfaut.
* Vrification de la configuration du systme : le plugin va vrifier que la configuration du serveur est compatible avec post-thumb.
** Fichiers distants : vrifie que fopen est autoris ou cURL disponible.
** PHP version : L'utilisation de fichiers distants requiert galement php 4.3.0 ou suprieur.
** GD version : la bibliothque GD 2 est requise.


= Options des noms de fichiers =

* Ajoute aprs : Slectionner pour ajouter du texte aprs le nom de l'image pour constituer le nom du thumbnail. Dslectionner pour le mettre avant.
* Texte  ajouter : Choix du texte  ajouter au nom de l'image pour constituer le nom du thumbnail. Exemple : thumb_yourimage.jpg

= Options des Vidos =

* RegEx pour les vidos : If you want to scan a post for a video and use a default image. Uses regex to scan for video.
* Image par dfaut des vidos :


= Options des flux Vido =
* Vrification des flux vido : Slection si vous souhaitez scanner les flux vidos dans les articles et afficher une image par dfaut. Accepte : Youtube, Gvideo and Dailymotion. Le thumbnail sera affich en fonction de la source.


= Options des images =

* Taille de redimensionnement :
* Qualit des jpeg : De 0  100 (quait la meilleure, taille maximum). Dfaut: 75
* Conserver les proportions : cochez cette option si vous voulez conserver l'aspect de l'image d'origine.
* Utiliser les arrondis d'angle : Angle des arrondis. De 0  1. Typique : 0.15
* Utiliser les png : Cochez cette option si vous voulez sauvegarder les miniatures au format png.
Cocher cette option va augmenter la taille des miniatures mais sera utilise si les arrondis d'angle sont slectionns.
* Utiliser le masque unsharp : Cochez cette option si vous voulez appliquer un filtre de sharpness aux miniatures. AVERTISSEMENT : cocher cette option va ralentir la cration des miniatures.
* Niveau d'unsharp : De 0  100. Typique : 80
* Rayon d'unsharp : De 0  1. Typique : 0.5
* Unsharp threshold : De 0  5. Typique : 3


= Options Highslide =

* Utiliser Highslide dans les articles : Dslectionner cette option dsactivera tous les effets Highslide
* Style de bordure des images :
* Style de bordure des autres cadres :
* Couleur des cadres :
* Utiliser Highslide dans les articles :
* Dtection des media wordTube :
* Taille wordTube (largeur x hauteur) : Taille de la miniature wordTube.
* Texte wordTube : Texte prfix aux noms des miniatures wordTube.
* Dtection vidos Youtube :
* Taille affichage Youtube (largeur x hauteur) : Taille de la miniature Youtube
* Taille de lecture Youtube (largeur x hauteur) : Taille de la fentre d'affichage des vidos Youtube.

= Options supplmentaires =
* Replace image by thumbnail in posts : Check this option if you want Post-Thumb to replace images by thumbnails in posts.
* Taille de redimensionnement :
* Texte  ajouter : Choix du texte  ajouter au nom de l'image pour constituer le nom du thumbnail. Exemple : pthumb_yourimage.jpg
* Conserver les proportions : cochez cette option si vous voulez conserver l'aspect de l'image d'origine.
* Utiliser les arrondis d'angle :
* Utiliser les png : Cochez cette option si vous voulez sauvegarder les miniatures au format png.
* Utiliser le masque unsharp : Cochez cette option si vous voulez appliquer un filtre de sharpness aux miniatures. AVERTISSEMENT : cocher cette option va ralentir la cration des miniatures.



== Mise en forme ==

Post-thumb renvoie du code html pur. Par consquent, la mise en page peut tre integralement gre avec CSS.



== Fonctions de la Boucle ==

get_single_thumb () : Renvoie la miniature formate de l'article en cours.
pt_the_excerpt() : Renvoie la miniature (+ Titre) + Excerpt.



== Fonctions de la Sidebar ==

get_single_thumb () : Renvoie la miniature formate d'un article.
get_recent_thumbs () : Renvoie les miniatures des derniers articles.
get_random_thumb() : Renvoie la miniature d'un ou plusieurs articles au hasard.



== Constante supplmentaire pour les thmes ==

POSTHUMB_INFRAME. Cette constante est dfinie chaque fois que vous appelez une page de votre blog. Elle est mise  0 si l'appel est direct, et  1 si l'appel est fait dans une fentre ouverte par highslide.

Cela vous permet de modifier l'apparence du thme dans les cadres popup.

Exemple :
		<?php if (POSTHUMB_INFRAME == 0) { ?>
			<?php get_sidebar(); ?>
		<?php } ?>

		Cela masquera la sidebar si la page est affiche dans un cadre popup.



== Paramtres ==

Chaque fonction peut tre utilise avec de nombreux paramtres qui permettent de contrler l'affichage ou l'emplacement et le nom de sauvegarde des miniatures. Vous n'avez pas besoin de les utiliser  moins de vouloir utiliser des options diffrentes de celles par dfaut dfinies dans l'cran d'administration.

Chaque paramtre doit tre saisi avec sa valeur spare par un "=" et spar des autres paramtres par un '&'.

Exemple :
		<?php get_recent_thumb('WIDTH=100&HEIGHT=80&ROUNDED=1&LIMIT=12'); ?>



= Paramtres d'affichage =

* WIDTH: resize width. Overides default if greater than 0.
* HEIGHT: resize height. Overides default if greater than 0.
* HCROP: horizontal crop. Crops if greater than 0.
* VCROP: vertical crop. Crops if greater than 0.
* KEEPRATIO: if set to 1, image ratio is kept. Overides default if it exists.
* ROUNDED: creates thumbnails with rounded corners. Overides default if it exists.



= Paramtres supplmentaires d'affichage =

* TEXTBOX:  write a text in the bottom = 1. Default is 0.
* TEXT:  text to be written if TEXTBOX is set to 1.
* SHOWTITLE: display title, author or date below the thumbnail. Parameters: T, A, D.
* TITLE: choose wether content (C), excerpt (E) or title (T) is used in title tag of the thumbnail. Default is 'T'.
* MYCLASSHREF: output class name in html`<a class="myclasshref" href=...>`
* MYCLASSIMG: output class name in html`<img class="myclassimg" href=...>`
* LB_EFFECT: use highslide to display image or link.
* CAPTION: display or not the caption for pictures.



= Paramtres de sauvegarde =

* ALTAPPEND: text to append to create thumbnail name. Overide default if exists.
* BASENAME: force generation of thumbnail and use generic name. Default is 0. Used in the random function.
* SUBFOLDER: name of the subfolder to save thumbnails in. Only one level, no wrapping '/'.



= Paramtres de thme =

* USECATNAME: choose if category default image should used or not. Override default if exists.
* SHOWPOST: force Highslide to expand on post if set to 1. Default is 0 (expand on image or post)



= Paramtres de get_recent_thumb =

* LIMIT: number of posts to display
* OFFSET: skip posts by the given number. Default is 0.
* CATEGORY: categories to get posts from, or categories to exclude from search.


= Paramtres de get_random_thumb =

* LIMIT: number of posts to check to return a random image. Default is 5.
* RLIMIT: number of posts to display.
* CATEGORY: category to search random from.



== Addtionnal functions ==

In addition to the basic function, Post-Thumb comes with two plugins which can be activated separately and adds new functions.
= Post-thumb-post-library =
* wordTube media tags: will wrap each video or mp3 with a thumbnail.
* youtube specific tag: will wrap youtube player with a thumbnail.
* automatic thumbnailing in posts: the plugin will scan for the entire post and will thumbnail all pictures which has the attribute rel="thumb" on it.
* automatic expand effect: the plugin will scan for the entire post and will add the Highslide expansion effect to each thumbnail link to a url.
= Post-thumb-template library =




== Formattage des articles ==

= Images et miniatures =

Si vous insrer une image avec une miniature dans un article, par exemple, avec Image Manager, vous pouvez choisir d'afficher l'image en utilisant Highslide.
Cela peut tre activ/dsactiv dans Options->Options Highslide->Utiliser Highslide dans les articles.

Si vous ajoutez rel="thumb" au lien d'une image dans un article, le plugin crera automatiquement la miniature et la placera dans l'article.
Cela peut tre activ/dsactiv dans les options et l'aspect des miniatures peut tre dfini dans les options. Tout cela se trouve dans les Options supplmentaires.

= Media wordTube =

Les media WordTube peuvent tre dtects et affich avec des miniatures. Le media sera jou dans un cadre popup en cliquant sur la miniature.
Voir les Options pour ajuster les paramtres.



= Playlist wordTube =

Post-thumb revisited fournit son propre systme de playlist pour wordTube.

* [PTPLAYLIST=(n,n,n)|WIDTH=xxx|HEIGHT=xxx|MP3/FLV]
MP3/FLV will select either one of the two. Default is all (none selected). Playlist with 0 will select all media.



== Insertion de vidos Youtube ==

Les vidos Youtube peuvent tre insres dans les articles en utilisant une balise simple. The tag will display a thumbnail and the video will be viewed in an expanded frame when clicking on it.

* [YOUTUBE=(video ID) title=(video title)]




== Widgets ==

Widgets are gathered in the Post-thumb widgets plugin. It needs to be activated. If your theme is widget ready, then the followings wil be available:

Fonctions supporte :

* pt-random : returns thumbnails from random posts
* pt-recent : returns thumbnails from most recent posts
* pt-categories : list categories. Same as wp_list_categories but adds a popup link.
* pt-bookmarks : list bookmarks. Same as wp_list_bookmarks but opens link in a popup frame.
* pt-wordTube : to display a thumbnail linked to a wordTube media in the sidebar

Fonctions non-supportes :

* pt-slideshow
* pt-news


